Documentation on ellint

Task: ellint
Purpose: Integrate a Miriad image in elliptical annuli.
Categories: image analysis

        ELLINT integrates a Miriad image in elliptical annuli in the first
        two dimensions. E.g. to find the radial brightness distribution,
        or flux density as a function of distance in a galaxy. The
        integration is done separately for each image plane in the region
        included.

        The output consists of 6 columns. They are the

        outer radius (arcsec) of the annulus
        number of pixels in the annulus
        the average (or median or mode) in the annulus
        the rms of the annulus
        the sum in the annulus (normalized by the volume of the primary beam
           if there is one)
        the cumulative sum for all annuli so far

Key: in
        Input image name. xyz images only. No default.

Key: region
        Region of image to be integrated. E.g.
          % ellint region=relpix,box(-4,-4,5,5)(1,2)
        integrates the center 10 x 10 pixels for image planes 1 and 2.
        Unmasked pixels within the bounding box are selected.
        The default region is the entire image.

Key: center
        The offset of the center of the annuli in arcsec from the
        reference pixel, measured in the directions of RA and DEC.

Key: pa
        Position angle of ellipse major axis in degrees. Default is 0 (north).

Key: incline
        Inclination angle in degrees. Default=0. (face on)

Key: radius
        Inner and outer radii and step size along major axis in arcsecs.
        The default is the whole image in steps equal to the pixel size.

Key: wedge
       Opening angle (degrees) of wedge in which to integrate. 
       Integration is within (pa +/- wedge). Default=180.

Key: pbtype
        If you request that the fluxes be corrected for the primary beam
        (see OPTIONS), ELLINT will normally construct a primary beam type
        using information from the dataset. However you can override this
        with a primary beam type of your own choosing. The primary beam
        type can either be a telescope name whose primary beam is known
        (e.g. hatcreek, vla, atca, etc) or you can select a Gaussian form
        with "gaus(xxx)". Here xxx is the primary beam FWHM in arcseconds.
        For example gaus(120) is a telescope with a 120 arcsec primary beam.

Key: options
        Task enrichment options.  Minimum match is active.
          pbcorr    means correct the image for the primary beam
                    attenutation before integrating.
          median    Find the median of each annulus instead of the average
         olay      Write an overlay file showing the region that was sampled.
                   The output filename will be  logfile .olay. If no log file
                   specified, the o/p goes to the terminal.

Key: log
        The output log file. The default is the terminal.